home *** CD-ROM | disk | FTP | other *** search
/ Resource Library: Multimedia / Resource Library: Multimedia.iso / archvrs / msdos / unshar / unshar.doc < prev    next >
Encoding:
Text File  |  1986-09-25  |  2.5 KB  |  81 lines
  1.  
  2.                ---    UNSHAR    ---
  3.  
  4.           ---   Copywrite 24 September, 1986   ---
  5.               ---    John Birchfield      ---
  6.               ---    411 Crane Ave.       ---
  7.               ---    Turlock, CA  95380   ---
  8.               ---      (209) 634-6243     ---
  9.  
  10.     Program to decode files created by the shell archive { shar }
  11.     utility on Un*x machines or pc's.
  12.     
  13.     CAPABILITIES:
  14.  
  15.     1.    Able to unshar into a user specified directory or subdirectory
  16.         as specified by a command line option { -Ddirectory_name }
  17.  
  18.     2.    Recognizes the following commands
  19.             cat, sed, uudecode, mkdir, chdir, 
  20.             {test -f, test -d, test <number -ne wc ... }
  21.  
  22.     3.    Can handle shar scripts created with the
  23.             Options { -a -v -p -b -c -d }
  24.  
  25.     4.    Successfully traverses directories and sub-directories
  26.         creating the necessary subdirectories as necessary.
  27.  
  28.     OPTIONS:
  29.     
  30.         -T    UNSHAR will return TRUE from a test he doesn't
  31.             know how to complete
  32.             
  33.         -D<directory>    UNSHAR will build all the files beginning
  34.             at the directory specified.  This works on different
  35.             drives also.  For example, if you wished the shar
  36.             script in your current directory to be extracted to
  37.             D:/BIN you could enter
  38.             
  39.                 UNSHAR -DD:/BIN <shar script file name>
  40.                 
  41.             Either '\\' or '/' are acceptable as directory
  42.             node separaters.  I happen to prefer '/'.
  43.             Also note that
  44.             
  45.                 unshar -d/bin/sub1/sub2/sub3 <filename>
  46.  
  47.             would extract files to that directory { creating
  48.             all necessary sub-directories above it to get
  49.             to that level }.  If you left out the leading
  50.             '/' then they would be created on top of the
  51.             current path of the currently logged on drive.
  52.             That is to say that if your current path was
  53.             
  54.                 c:/usr/src/c/bin/sub1/sub2/sub3
  55.                 
  56.             Possibly not what you had in mind.
  57.  
  58.         Both options may be specified in either upper or lower
  59.         case.
  60.  
  61.     CAVEATS:
  62.         Word Counting between Un*x machines and pc's just isn't
  63.         gonna work out too well.  The \r\n - \n thing is not
  64.         an easy thing to work around - and to be quite frank
  65.         I just ain't up to it.
  66.         
  67.         UNSHAR does sub-directory traversal in the same manner
  68.         as Un*x - be advised - the right kind of shar script
  69.         will fill your disk ...
  70.  
  71.     Program written for the Desmet (C-Ware) C Compiler Version 2.61
  72.     not all of the routines in DOS_C.C and DOS_A.A are used by this
  73.     program.  The program consists of the following modules:
  74.         UNSHAR.C
  75.         SHAR_CMD.C
  76.         DOS_C.C
  77.         DOS_A.A
  78.  
  79.     This program is hereby placed in the public domain for 
  80.     non-commersial use.
  81.